Skip to content

Conversation

chr-hertel
Copy link
Member

Q A
Bug fix? no
New feature? yes
Docs? yes
Issues
License MIT

Cherry picking php-llm/llm-chain#366

@chr-hertel chr-hertel added the Platform Issues & PRs about the AI Platform component label Jul 16, 2025
This PR adds support for [Albert
API](https://github.com/etalab-ia/albert-api), the French government's
sovereign AI gateway. Albert provides an OpenAI-compatible API interface
for various language models while ensuring data sovereignty and
compliance with French/EU regulations.

- 🇫🇷 **Sovereign AI**: Albert is hosted and operated by the French
government
- 🔧 **OpenAI-compatible**: Uses the same API structure as OpenAI
- 🔒 **Data Privacy**: Ensures data remains within French/EU jurisdiction
- 🎯 **Public Sector Focus**: Designed for use by French public
administration

- Created Albert-specific model clients (GPTModelClient and
EmbeddingsModelClient) with configurable base URL
- Added PlatformFactory for easy Albert API initialization
- Reuses OpenAI's response converters for compatibility
- Supports both chat completions and embeddings endpoints

```php
use PhpLlm\LlmChain\Platform\Bridge\Albert\PlatformFactory;
use PhpLlm\LlmChain\Platform\Bridge\OpenAI\GPT;

$platform = PlatformFactory::create(
    apiKey: $_ENV['ALBERT_API_KEY'],
    albertUrl: $_ENV['ALBERT_API_URL']
);

$model = new GPT('gpt-4o');
$chain = new Chain($platform, $model);
```

- Added unit tests for PlatformFactory
- Added example script demonstrating Albert API usage with RAG context
- All tests pass and code follows project standards

- Updated README to list Albert as a supported platform
- Added example file showing how to use Albert API
- Included context about French AI strategy in the example

This implementation allows French public sector organizations to
leverage LLM Chain while maintaining data sovereignty and regulatory
compliance.

Closes #346
@chr-hertel chr-hertel force-pushed the feat/albert-api-support branch from d7020ed to 99ce42a Compare July 16, 2025 21:31
@chr-hertel chr-hertel changed the title feat: add Albert API support [Platform] add Albert API support Jul 16, 2025
@OskarStark
Copy link
Contributor

Changelog can be found here:

@chr-hertel
Copy link
Member Author

Thank you @OskarStark.

@chr-hertel chr-hertel merged commit 88826f8 into main Jul 17, 2025
26 checks passed
chr-hertel added a commit that referenced this pull request Jul 17, 2025
This PR was merged into the main branch.

Discussion
----------

[Platform] Add Albert API to platform CHANGELOG

## Summary
- Added Albert API to the platform CHANGELOG as it was missing from PR #140

This PR adds the changelog entry for the Albert API support that was merged in #140. The Albert API is a French sovereign AI gateway that provides OpenAI-compatible endpoints while ensuring data remains within French/EU jurisdiction.

## References
- Original PR: #140

Commits
-------

eb88a4c Add Albert API support to platform CHANGELOG
@OskarStark
Copy link
Contributor

friendly ping @gundesli

@OskarStark OskarStark deleted the feat/albert-api-support branch July 17, 2025 11:58
@gundesli
Copy link

Very nice, thank you @OskarStark 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Platform Issues & PRs about the AI Platform component
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants